Create Chat
Erstelle einen neuen Telegram-Gruppenchat oder -Kanal.
Der gewählte Telegram Client erstellt einen neuen Gruppenchat oder Kanal und lädt andere Telegram-Accounts in den Chat ein.
In adaptor:ex wird gleichzeitig ein Data Item in der chats
collection angelegt, das den Chat repräsentiert.
Settings
Du kannst bereits beim Erstellen des Chats die meisten Optionen festlegen. Wenn du bestimmte Optionen später ändern willst, nutze die Edit Chat action.
Telegram Client
Der Client, der den Chat erstellen soll. Dieser Account ist automatisch Admin der neu erstellten Gruppe.
type
Lege fest, ob du einen Gruppenchat (chat
) oder Kanal (channel
) erstellen willst. Hier ist der Unterschied erklärt: https://telegram.org/faq#f-was-ist-der-unterschied-zwischen-gruppen-und-kanalen
name
Lege einen Namen für deine Gruppe oder deinen Kanal fest. Wenn du keinen title
festlegst erscheint name
im Titel des Chats.
Wenn name
keine Sonderzeichen oder Leerzeichen enthält kannst du name
nutzen um den Chat in einem anderen Level bzw. in einer anderen Session zu adressieren. Etwa: [[chats.Chatname]]
Bedenke, dass name
in diesem Fall für jeden Chat einzigartig sein muss.
Um den Chat im aktuellen Level bzw. der aktuellen Session eindeutig zu adressieren empfehlen wir reference
verwenden.
title
Gib einen Titel für den Chat an.
members
Eine Liste der Mitglieder, die der Gruppe hinzugefügt werden sollen.
Verwende Data Items, player oder telegram clients, die mit einem Telegram-Account verbunden sind.
Beispiele:
Player
- füge den player aus dem level Argument Player hinzu
player.{'telegram.first_name':'Amanda'}
- füge den Spieler-Eintrag aus der player
collection hinzu, der in seinem Telegram Account den Vornamen "Amanda" angegeben hat
telegram.client.Chris
- lade den Telegram Client Chris
in den Chat ein.
photo
Lade ein Gruppenbild für den Chat hoch.
Nutze dafür eine Bilddatei aus deinen Files.
about
Füge eine Textbeschreibung für die Gruppe hinzu.
permissions
Lege fest, welche Interaktionen für Mitglieder des Chats, die nicht Admins sind, erlaubt sind.
Verbiete eine Interaktionsmöglichkeit, indem du die permission abwählst.
Gruppenmitglieder ohne Admin-Status können in diesem Beispiel keine Mediendateien, GIFs oder Sticker versenden.
reference
Gib beim Erstellen des chats einen reference
Wert an. So kannst du den Chat anschließend im selben Level einfach adressieren.
Wenn du die Referenz in den Telegram actions als chat
oder to
angibst, wird der Telegram Chat adressiert. In anderen actions verweist die Referenz auf das chat
Data Item und du kannst auf seine Eigenschaften zugreifen.
Chatdaten
Das Data Item, das mit dem Chat erstellt wurde, enthält Informationen über den Chat, die beständig aktualisiert werden.
Beachte: wenn der adaptor:ex Server nicht aktiv ist während Änderungen am Chat passieren, werden diese Änderungen nicht im Data Item angepasst
Über reference
oder name
kannst du das Chat Item adressieren und die Chat Daten als variablen in anderen actions verwenden.
Die folgenden Daten können im Chat Item enthalten sein
-
name
- der Name des Chats.name
ist nicht notwendigerweise der Titel des Chats -
title
- Der Anzeigename des Chats -
members
- Liste der telegram ids der Gruppenmitglieder -
member_count
- Anzahl der Gruppenmitglieder. Der Client, der den Chat erstellt hat wird hier nicht mitgezählt! -
telegram
- Telegram Eigenschaften dieses chats wieid
undparticipants_count
-
poll
- Umfragen, die in diesem Chat mit Send Poll oder Send Quiz erstellt wurden.poll
enthält Send Poll Umfragedaten
Beispiel
Erstellt einen neuen Gruppenchat "Better Together" für den Telegram Client "Thekla", in den der Telegram-Account von "Player" und dem player mit der name
variable "Arvid" eingeladen wird.
Da wir beim Erstellen des chats einen reference
Wert angegeben haben, können wir den Chat anschließend im selben Level z.B. in der Send Message action adressieren.
Du kannst den Chat auch über die chats
collection adressieren, z.B. wenn du ihn in einem Level verwenden willst, das nicht über die Referenz verfügt.
Adressiere den Chat über eine Query:
[[chats.{name:"Better Together"}]]
Wenn du keine Leerzeichen verwendet hast, kannst du den Namen auch direkt verwenden, z.B.:
[[chats.BetterTogether]]